[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 U_STAT(IEXP) (DATE or INTEGER)

 Function
  Get a statistic about the current user.

 Syntax
  U_TIMEON(stat)

   stat = The statistic to retrieve (1 through 15).

 Return Type & Value
  A statistic about the user that is tracked by PCBoard is return based
  on the value of IEXP as follows:

  Type     stat  Description
  -------  ----  -----------------------------------------------
  DATE       1 - first date the user called the system
  INTEGER    2 - number of SysOp pages the user has requested
             3 - number of group chats the user has participated in
             4 - number of comments the user has left
             5 - number of 300 bps connects
             6 - number of 1200 bps connects
             7 - bumber of 2400 bps connects
             8 - number of 9600 bps connects
             9 - number of 14400 bps connects
            10 - number of security violations
            11 - number of "not registered in conference" warnings
            12 - number of times the users download limit has been reached
            13 - number of "file not found" warnings
            14 - number of password errors the user has had
            15 - number of verify errors the user has had

 Remarks
  PCBoard has the ability to track a number of statistics about the user.
  This function will return the desired statistic for the user currently
  online.  Unlike the predefined U_... user variables, this function does
  not require the use of GETUSER to return valid information.  However, it
  does require that the statistics PSA has been installed to return
  meaningful information.  The existence of the statistics PSA may be
  checked via the PSA() function.

 Examples
  STRING  label
  INTEGER i
  FOPEN 1,PPEPATH()+"STATTEXT",O_RD,S_DN
  FOR i = 1 TO 15
    FGET 1,label
    PRINTLN label," - ",U_STAT(i)
  NEXT
  FCLOSE 1

See Also: PSA()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson